home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XDrawPoint.z / XDrawPoint
Encoding:
Text File  |  2002-10-03  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXDDDDrrrraaaawwwwPPPPooooiiiinnnntttt((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXDDDDrrrraaaawwwwPPPPooooiiiinnnntttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XDrawPoint, XDrawPoints, XPoint - draw points and points
  10.           structure
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XDrawPoint(_d_i_s_p_l_a_y, _d, _g_c, _x, _y)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Drawable _d;
  16.                 GC _g_c;
  17.                 int _x, _y;
  18.  
  19.           XDrawPoints(_d_i_s_p_l_a_y, _d, _g_c, _p_o_i_n_t_s, _n_p_o_i_n_t_s, _m_o_d_e)
  20.                 Display *_d_i_s_p_l_a_y;
  21.                 Drawable _d;
  22.                 GC _g_c;
  23.                 XPoint *_p_o_i_n_t_s;
  24.                 int _n_p_o_i_n_t_s;
  25.                 int _m_o_d_e;
  26.  
  27.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  28.           _d         Specifies the drawable.
  29.  
  30.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  31.  
  32.           _g_c        Specifies the GC.
  33.  
  34.           _m_o_d_e      Specifies the coordinate mode. You can pass
  35.                     _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n or _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s.
  36.  
  37.           _n_p_o_i_n_t_s   Specifies the number of points in the array.
  38.  
  39.           _p_o_i_n_t_s    Specifies an array of points.
  40.  
  41.           _x
  42.           _y         Specify the x and y coordinates where you want the
  43.                     point drawn.
  44.  
  45.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  46.           The _X_D_r_a_w_P_o_i_n_t function uses the foreground pixel and
  47.           function components of the GC to draw a single point into
  48.           the specified drawable; _X_D_r_a_w_P_o_i_n_t_s draws multiple points
  49.           this way.  _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n treats all coordinates as
  50.           relative to the origin, and _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s treats all
  51.           coordinates after the first as relative to the previous
  52.           point.  _X_D_r_a_w_P_o_i_n_t_s draws the points in the order listed in
  53.           the array.
  54.  
  55.           Both functions use these GC components: function, plane-
  56.           mask, foreground, subwindow-mode, clip-x-origin, clip-y-
  57.           origin, and clip-mask.
  58.  
  59.           _X_D_r_a_w_P_o_i_n_t can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C, and _B_a_d_M_a_t_c_h
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXDDDDrrrraaaawwwwPPPPooooiiiinnnntttt((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXDDDDrrrraaaawwwwPPPPooooiiiinnnntttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           errors.  _X_D_r_a_w_P_o_i_n_t_s can generate _B_a_d_D_r_a_w_a_b_l_e, _B_a_d_G_C,
  75.           _B_a_d_M_a_t_c_h, and _B_a_d_V_a_l_u_e errors.
  76.  
  77.      SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEESSSS
  78.           The _X_P_o_i_n_t structure contains:
  79.  
  80.           typedef struct {
  81.                short x, y;
  82.           } XPoint;
  83.  
  84.           All x and y members are signed integers.  The width and
  85.           height members are 16-bit unsigned integers.  You should be
  86.           careful not to generate coordinates and sizes out of the
  87.           16-bit ranges, because the protocol only has 16-bit fields
  88.           for these values.
  89.  
  90.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  91.           _B_a_d_D_r_a_w_a_b_l_e
  92.                     A value for a Drawable argument does not name a
  93.                     defined Window or Pixmap.
  94.  
  95.           _B_a_d_G_C     A value for a GContext argument does not name a
  96.                     defined GContext.
  97.  
  98.           _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  99.  
  100.           _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct
  101.                     type and range but fails to match in some other
  102.                     way required by the request.
  103.  
  104.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  105.                     values accepted by the request.  Unless a specific
  106.                     range is specified for an argument, the full range
  107.                     defined by the argument's type is accepted.  Any
  108.                     argument defined as a set of alternatives can
  109.                     generate this error.
  110.  
  111.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.           XDrawArc(3X11), XDrawLine(3X11), XDrawRectangle(3X11)
  113.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.